<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
<title>MapUtils (Apache Commons Collections 4.0 API)</title>
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
</head>
<body>
<script type="text/javascript"><!--
    if (location.href.indexOf('is-external=true') == -1) {
        parent.document.title="MapUtils (Apache Commons Collections 4.0 API)";
    }
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar_top">
<!--   -->
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
<!--   -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/MapUtils.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../index-all.html">Index</a></li>
<li><a href="../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../org/apache/commons/collections4/MapIterator.html" title="interface in org.apache.commons.collections4"><span class="strong">Prev Class</span></a></li>
<li><a href="../../../../org/apache/commons/collections4/MultiMap.html" title="interface in org.apache.commons.collections4"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?org/apache/commons/collections4/MapUtils.html" target="_top">Frames</a></li>
<li><a href="MapUtils.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
  allClassesLink = document.getElementById("allclasses_navbar_top");
  if(window==top) {
    allClassesLink.style.display = "block";
  }
  else {
    allClassesLink.style.display = "none";
  }
  //-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_top">
<!--   -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.commons.collections4</div>
<h2 title="Class MapUtils" class="title">Class MapUtils</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>org.apache.commons.collections4.MapUtils</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr>
<br>
<pre>public class <span class="strong">MapUtils</span>
extends <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Provides utility methods and decorators for
 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> and <a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util"><code>SortedMap</code></a> instances.
 <p>
 It contains various type safe methods
 as well as other useful features like deep copying.
 <p>
 It also provides the following decorators:

  <ul>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#fixedSizeMap(java.util.Map)"><code>fixedSizeMap(Map)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#fixedSizeSortedMap(java.util.SortedMap)"><code>fixedSizeSortedMap(SortedMap)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#lazyMap(java.util.Map, org.apache.commons.collections4.Factory)"><code>lazyMap(Map,Factory)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#lazyMap(java.util.Map, org.apache.commons.collections4.Transformer)"><code>lazyMap(Map,Transformer)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#lazySortedMap(java.util.SortedMap, org.apache.commons.collections4.Factory)"><code>lazySortedMap(SortedMap,Factory)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#lazySortedMap(java.util.SortedMap, org.apache.commons.collections4.Transformer)"><code>lazySortedMap(SortedMap,Transformer)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#predicatedMap(java.util.Map, org.apache.commons.collections4.Predicate, org.apache.commons.collections4.Predicate)"><code>predicatedMap(Map,Predicate,Predicate)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#predicatedSortedMap(java.util.SortedMap, org.apache.commons.collections4.Predicate, org.apache.commons.collections4.Predicate)"><code>predicatedSortedMap(SortedMap,Predicate,Predicate)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#transformedMap(java.util.Map, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)"><code>transformedMap(Map, Transformer, Transformer)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#transformedSortedMap(java.util.SortedMap, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)"><code>transformedSortedMap(SortedMap, Transformer, Transformer)</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#multiValueMap(java.util.Map)"><code>multiValueMap( Map )</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#multiValueMap(java.util.Map, java.lang.Class)"><code>multiValueMap( Map, Class )</code></a>
  <li><a href="../../../../org/apache/commons/collections4/MapUtils.html#multiValueMap(java.util.Map, org.apache.commons.collections4.Factory)"><code>multiValueMap( Map, Factory )</code></a>
  </ul></div>
<dl><dt><span class="strong">Since:</span></dt>
  <dd>1.0</dd>
<dt><span class="strong">Version:</span></dt>
  <dd>$Id: MapUtils.java 1543964 2013-11-20 21:53:39Z tn $</dd></dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field_summary">
<!--   -->
</a>
<h3>Field Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
<caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#EMPTY_SORTED_MAP">EMPTY_SORTED_MAP</a></strong></code>
<div class="block">An empty unmodifiable sorted map.</div>
</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method_summary">
<!--   -->
</a>
<h3>Method Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span>Methods</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static void</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#debugPrint(java.io.PrintStream, java.lang.Object, java.util.Map)">debugPrint</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
          <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;label,
          <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;map)</code>
<div class="block">Prints the given map with nice line breaks.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#emptyIfNull(java.util.Map)">emptyIfNull</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</code>
<div class="block">Returns an immutable empty map if the argument is <code>null</code>,
 or the argument itself otherwise.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#fixedSizeMap(java.util.Map)">fixedSizeMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</code>
<div class="block">Returns a fixed-sized map backed by the given map.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#fixedSizeSortedMap(java.util.SortedMap)">fixedSizeSortedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map)</code>
<div class="block">Returns a fixed-sized sorted map backed by the given sorted map.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getBoolean(java.util.Map, K)">getBoolean</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
          K&nbsp;key)</code>
<div class="block">Gets a Boolean from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getBoolean(java.util.Map, K, java.lang.Boolean)">getBoolean</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
          K&nbsp;key,
          <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</a>&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 a boolean, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getBooleanValue(java.util.Map, K)">getBooleanValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
               K&nbsp;key)</code>
<div class="block">Gets a boolean from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getBooleanValue(java.util.Map, K, boolean)">getBooleanValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
               K&nbsp;key,
               boolean&nbsp;defaultValue)</code>
<div class="block">Gets a boolean from a Map in a null-safe manner,
 using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Byte.html?is-external=true" title="class or interface in java.lang">Byte</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getByte(java.util.Map, K)">getByte</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
       K&nbsp;key)</code>
<div class="block">Gets a Byte from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Byte.html?is-external=true" title="class or interface in java.lang">Byte</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getByte(java.util.Map, K, java.lang.Byte)">getByte</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
       K&nbsp;key,
       <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Byte.html?is-external=true" title="class or interface in java.lang">Byte</a>&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 a byte, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;byte</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getByteValue(java.util.Map, K)">getByteValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
            K&nbsp;key)</code>
<div class="block">Gets a byte from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;byte</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getByteValue(java.util.Map, K, byte)">getByteValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
            K&nbsp;key,
            byte&nbsp;defaultValue)</code>
<div class="block">Gets a byte from a Map in a null-safe manner,
 using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang">Double</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getDouble(java.util.Map, K)">getDouble</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
         K&nbsp;key)</code>
<div class="block">Gets a Double from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang">Double</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getDouble(java.util.Map, K, java.lang.Double)">getDouble</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
         K&nbsp;key,
         <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang">Double</a>&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 a double, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;double</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getDoubleValue(java.util.Map, K)">getDoubleValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
              K&nbsp;key)</code>
<div class="block">Gets a double from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;double</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getDoubleValue(java.util.Map, K, double)">getDoubleValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
              K&nbsp;key,
              double&nbsp;defaultValue)</code>
<div class="block">Gets a double from a Map in a null-safe manner,
 using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Float.html?is-external=true" title="class or interface in java.lang">Float</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getFloat(java.util.Map, K)">getFloat</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
        K&nbsp;key)</code>
<div class="block">Gets a Float from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Float.html?is-external=true" title="class or interface in java.lang">Float</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getFloat(java.util.Map, K, java.lang.Float)">getFloat</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
        K&nbsp;key,
        <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Float.html?is-external=true" title="class or interface in java.lang">Float</a>&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 a float, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;float</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getFloatValue(java.util.Map, K)">getFloatValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
             K&nbsp;key)</code>
<div class="block">Gets a float from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;float</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getFloatValue(java.util.Map, K, float)">getFloatValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
             K&nbsp;key,
             float&nbsp;defaultValue)</code>
<div class="block">Gets a float from a Map in a null-safe manner,
 using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getInteger(java.util.Map, K)">getInteger</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
          K&nbsp;key)</code>
<div class="block">Gets a Integer from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getInteger(java.util.Map, K, java.lang.Integer)">getInteger</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
          K&nbsp;key,
          <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</a>&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 an integer, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;int</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getIntValue(java.util.Map, K)">getIntValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
           K&nbsp;key)</code>
<div class="block">Gets an int from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;int</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getIntValue(java.util.Map, K, int)">getIntValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
           K&nbsp;key,
           int&nbsp;defaultValue)</code>
<div class="block">Gets an int from a Map in a null-safe manner,
 using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang">Long</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getLong(java.util.Map, K)">getLong</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
       K&nbsp;key)</code>
<div class="block">Gets a Long from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang">Long</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getLong(java.util.Map, K, java.lang.Long)">getLong</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
       K&nbsp;key,
       <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang">Long</a>&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 a long, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;long</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getLongValue(java.util.Map, K)">getLongValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
            K&nbsp;key)</code>
<div class="block">Gets a long from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;long</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getLongValue(java.util.Map, K, long)">getLongValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
            K&nbsp;key,
            long&nbsp;defaultValue)</code>
<div class="block">Gets a long from a Map in a null-safe manner,
 using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getMap(java.util.Map, K)">getMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
      K&nbsp;key)</code>
<div class="block">Gets a Map from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getMap(java.util.Map, K, java.util.Map)">getMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
      K&nbsp;key,
      <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 a map, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)">getNumber</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
         K&nbsp;key)</code>
<div class="block">Gets a Number from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K, java.lang.Number)">getNumber</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
         K&nbsp;key,
         <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a>&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 a number, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;V</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getObject(java.util.Map, K)">getObject</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,V&gt;&nbsp;map,
         K&nbsp;key)</code>
<div class="block">Gets from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;V</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getObject(java.util.Map, K, V)">getObject</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
         K&nbsp;key,
         V&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting null into the
 given default value.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Short.html?is-external=true" title="class or interface in java.lang">Short</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getShort(java.util.Map, K)">getShort</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
        K&nbsp;key)</code>
<div class="block">Gets a Short from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Short.html?is-external=true" title="class or interface in java.lang">Short</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getShort(java.util.Map, K, java.lang.Short)">getShort</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
        K&nbsp;key,
        <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Short.html?is-external=true" title="class or interface in java.lang">Short</a>&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 a short, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;short</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getShortValue(java.util.Map, K)">getShortValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
             K&nbsp;key)</code>
<div class="block">Gets a short from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;short</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getShortValue(java.util.Map, K, short)">getShortValue</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
             K&nbsp;key,
             short&nbsp;defaultValue)</code>
<div class="block">Gets a short from a Map in a null-safe manner,
 using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getString(java.util.Map, K)">getString</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
         K&nbsp;key)</code>
<div class="block">Gets a String from a Map in a null-safe manner.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#getString(java.util.Map, K, java.lang.String)">getString</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
         K&nbsp;key,
         <a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;defaultValue)</code>
<div class="block">Looks up the given key in the given map, converting the result into
 a string, using the default value if the the conversion fails.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;V,K&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#invertMap(java.util.Map)">invertMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</code>
<div class="block">Inverts the supplied map returning a new HashMap such that the keys of
 the input are swapped with the values.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#isEmpty(java.util.Map)">isEmpty</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;map)</code>
<div class="block">Null-safe check if the specified map is empty.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#isNotEmpty(java.util.Map)">isNotEmpty</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;map)</code>
<div class="block">Null-safe check if the specified map is not empty.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#iterableMap(java.util.Map)">iterableMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</code>
<div class="block">Get the specified <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> as an <a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4"><code>IterableMap</code></a>.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableSortedMap.html" title="interface in org.apache.commons.collections4">IterableSortedMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#iterableSortedMap(java.util.SortedMap)">iterableSortedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;sortedMap)</code>
<div class="block">Get the specified <a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util"><code>SortedMap</code></a> as an <a href="../../../../org/apache/commons/collections4/IterableSortedMap.html" title="interface in org.apache.commons.collections4"><code>IterableSortedMap</code></a>.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#lazyMap(java.util.Map, org.apache.commons.collections4.Factory)">lazyMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
       <a href="../../../../org/apache/commons/collections4/Factory.html" title="interface in org.apache.commons.collections4">Factory</a>&lt;? extends V&gt;&nbsp;factory)</code>
<div class="block">Returns a "lazy" map whose values will be created on demand.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#lazyMap(java.util.Map, org.apache.commons.collections4.Transformer)">lazyMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super K,? extends V&gt;&nbsp;transformerFactory)</code>
<div class="block">Returns a "lazy" map whose values will be created on demand.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#lazySortedMap(java.util.SortedMap, org.apache.commons.collections4.Factory)">lazySortedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map,
             <a href="../../../../org/apache/commons/collections4/Factory.html" title="interface in org.apache.commons.collections4">Factory</a>&lt;? extends V&gt;&nbsp;factory)</code>
<div class="block">Returns a "lazy" sorted map whose values will be created on demand.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#lazySortedMap(java.util.SortedMap, org.apache.commons.collections4.Transformer)">lazySortedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map,
             <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super K,? extends V&gt;&nbsp;transformerFactory)</code>
<div class="block">Returns a "lazy" sorted map whose values will be created on demand.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/map/MultiValueMap.html" title="class in org.apache.commons.collections4.map">MultiValueMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#multiValueMap(java.util.Map)">multiValueMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,? super <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;V&gt;&gt;&nbsp;map)</code>
<div class="block">Creates a mult-value map backed by the given map which returns
 collections of type ArrayList.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V,C extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;V&gt;&gt;&nbsp;<br><a href="../../../../org/apache/commons/collections4/map/MultiValueMap.html" title="class in org.apache.commons.collections4.map">MultiValueMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#multiValueMap(java.util.Map, java.lang.Class)">multiValueMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,C&gt;&nbsp;map,
             <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;C&gt;&nbsp;collectionClass)</code>
<div class="block">Creates a multi-value map backed by the given map which returns
 collections of the specified type.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V,C extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;V&gt;&gt;&nbsp;<br><a href="../../../../org/apache/commons/collections4/map/MultiValueMap.html" title="class in org.apache.commons.collections4.map">MultiValueMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#multiValueMap(java.util.Map, org.apache.commons.collections4.Factory)">multiValueMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,C&gt;&nbsp;map,
             <a href="../../../../org/apache/commons/collections4/Factory.html" title="interface in org.apache.commons.collections4">Factory</a>&lt;C&gt;&nbsp;collectionFactory)</code>
<div class="block">Creates a multi-value map backed by the given map which returns
 collections created by the specified collection factory.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/OrderedMap.html" title="interface in org.apache.commons.collections4">OrderedMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#orderedMap(java.util.Map)">orderedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</code>
<div class="block">Returns a map that maintains the order of keys that are added
 backed by the given map.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V,E&gt;&nbsp;void</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#populateMap(java.util.Map, java.lang.Iterable, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)">populateMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
           <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends E&gt;&nbsp;elements,
           <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;E,K&gt;&nbsp;keyTransformer,
           <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;E,V&gt;&nbsp;valueTransformer)</code>
<div class="block">Populates a Map using the supplied <code>Transformer</code>s to transform the elements
 into keys and values.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;void</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#populateMap(java.util.Map, java.lang.Iterable, org.apache.commons.collections4.Transformer)">populateMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
           <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends V&gt;&nbsp;elements,
           <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;V,K&gt;&nbsp;keyTransformer)</code>
<div class="block">Populates a Map using the supplied <code>Transformer</code> to transform the elements
 into keys, using the unaltered element as the value in the <code>Map</code>.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V,E&gt;&nbsp;void</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#populateMap(org.apache.commons.collections4.MultiMap, java.lang.Iterable, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)">populateMap</a></strong>(<a href="../../../../org/apache/commons/collections4/MultiMap.html" title="interface in org.apache.commons.collections4">MultiMap</a>&lt;K,V&gt;&nbsp;map,
           <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends E&gt;&nbsp;elements,
           <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;E,K&gt;&nbsp;keyTransformer,
           <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;E,V&gt;&nbsp;valueTransformer)</code>
<div class="block">Populates a MultiMap using the supplied <code>Transformer</code>s to transform the elements
 into keys and values.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;void</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#populateMap(org.apache.commons.collections4.MultiMap, java.lang.Iterable, org.apache.commons.collections4.Transformer)">populateMap</a></strong>(<a href="../../../../org/apache/commons/collections4/MultiMap.html" title="interface in org.apache.commons.collections4">MultiMap</a>&lt;K,V&gt;&nbsp;map,
           <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends V&gt;&nbsp;elements,
           <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;V,K&gt;&nbsp;keyTransformer)</code>
<div class="block">Populates a MultiMap using the supplied <code>Transformer</code> to transform the elements
 into keys, using the unaltered element as the value in the <code>MultiMap</code>.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#predicatedMap(java.util.Map, org.apache.commons.collections4.Predicate, org.apache.commons.collections4.Predicate)">predicatedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
             <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super K&gt;&nbsp;keyPred,
             <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super V&gt;&nbsp;valuePred)</code>
<div class="block">Returns a predicated (validating) map backed by the given map.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#predicatedSortedMap(java.util.SortedMap, org.apache.commons.collections4.Predicate, org.apache.commons.collections4.Predicate)">predicatedSortedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map,
                   <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super K&gt;&nbsp;keyPred,
                   <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super V&gt;&nbsp;valuePred)</code>
<div class="block">Returns a predicated (validating) sorted map backed by the given map.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#putAll(java.util.Map, java.lang.Object[])">putAll</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
      <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[]&nbsp;array)</code>
<div class="block">Puts all the keys and values from the specified array into the map.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K&gt;&nbsp;void</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#safeAddToMap(java.util.Map, K, java.lang.Object)">safeAddToMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;map,
            K&nbsp;key,
            <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)</code>
<div class="block">Protects against adding null values to a map.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#synchronizedMap(java.util.Map)">synchronizedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</code>
<div class="block">Returns a synchronized map backed by the given map.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#synchronizedSortedMap(java.util.SortedMap)">synchronizedSortedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map)</code>
<div class="block">Returns a synchronized sorted map backed by the given sorted map.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#toMap(java.util.ResourceBundle)">toMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util">ResourceBundle</a>&nbsp;resourceBundle)</code>
<div class="block">Creates a new HashMap using data copied from a ResourceBundle.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</a></code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#toProperties(java.util.Map)">toProperties</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</code>
<div class="block">Gets a new Properties object initialised with the values from a Map.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#transformedMap(java.util.Map, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)">transformedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
              <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super K,? extends K&gt;&nbsp;keyTransformer,
              <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super V,? extends V&gt;&nbsp;valueTransformer)</code>
<div class="block">Returns a transformed map backed by the given map.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#transformedSortedMap(java.util.SortedMap, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)">transformedSortedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map,
                    <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super K,? extends K&gt;&nbsp;keyTransformer,
                    <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super V,? extends V&gt;&nbsp;valueTransformer)</code>
<div class="block">Returns a transformed sorted map backed by the given map.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#unmodifiableMap(java.util.Map)">unmodifiableMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? extends K,? extends V&gt;&nbsp;map)</code>
<div class="block">Returns an unmodifiable map backed by the given map.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static &lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#unmodifiableSortedMap(java.util.SortedMap)">unmodifiableSortedMap</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,? extends V&gt;&nbsp;map)</code>
<div class="block">Returns an unmodifiable sorted map backed by the given sorted map.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static void</code></td>
<td class="colLast"><code><strong><a href="../../../../org/apache/commons/collections4/MapUtils.html#verbosePrint(java.io.PrintStream, java.lang.Object, java.util.Map)">verbosePrint</a></strong>(<a href="http://download.oracle.com/javase/6/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
            <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;label,
            <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;map)</code>
<div class="block">Prints the given map with nice line breaks.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
<!--   -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
<code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field_detail">
<!--   -->
</a>
<h3>Field Detail</h3>
<a name="EMPTY_SORTED_MAP">
<!--   -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>EMPTY_SORTED_MAP</h4>
<pre>public static final&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a> EMPTY_SORTED_MAP</pre>
<div class="block">An empty unmodifiable sorted map.
 This is not provided in the JDK.</div>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method_detail">
<!--   -->
</a>
<h3>Method Detail</h3>
<a name="getObject(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getObject(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getObject</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;V&nbsp;getObject(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,V&gt;&nbsp;map,
                K&nbsp;key)</pre>
<div class="block">Gets from a Map in a null-safe manner.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getString(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getString(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getString</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;getString(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                   K&nbsp;key)</pre>
<div class="block">Gets a String from a Map in a null-safe manner.
 <p>
 The String is obtained via <code>toString</code>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a String, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getBoolean(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getBoolean(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBoolean</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</a>&nbsp;getBoolean(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                     K&nbsp;key)</pre>
<div class="block">Gets a Boolean from a Map in a null-safe manner.
 <p>
 If the value is a <code>Boolean</code> it is returned directly.
 If the value is a <code>String</code> and it equals 'true' ignoring case
 then <code>true</code> is returned, otherwise <code>false</code>.
 If the value is a <code>Number</code> an integer zero value returns
 <code>false</code> and non-zero returns <code>true</code>.
 Otherwise, <code>null</code> is returned.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Boolean, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getNumber(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getNumber(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getNumber</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a>&nbsp;getNumber(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                   K&nbsp;key)</pre>
<div class="block">Gets a Number from a Map in a null-safe manner.
 <p>
 If the value is a <code>Number</code> it is returned directly.
 If the value is a <code>String</code> it is converted using
 <a href="http://download.oracle.com/javase/6/docs/api/java/text/NumberFormat.html?is-external=true#parse(java.lang.String)" title="class or interface in java.text"><code>NumberFormat.parse(String)</code></a> on the system default formatter
 returning <code>null</code> if the conversion fails.
 Otherwise, <code>null</code> is returned.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Number, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getByte(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getByte(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getByte</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Byte.html?is-external=true" title="class or interface in java.lang">Byte</a>&nbsp;getByte(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
               K&nbsp;key)</pre>
<div class="block">Gets a Byte from a Map in a null-safe manner.
 <p>
 The Byte is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Byte, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getShort(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getShort(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getShort</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Short.html?is-external=true" title="class or interface in java.lang">Short</a>&nbsp;getShort(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                 K&nbsp;key)</pre>
<div class="block">Gets a Short from a Map in a null-safe manner.
 <p>
 The Short is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Short, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getInteger(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getInteger(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getInteger</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</a>&nbsp;getInteger(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                     K&nbsp;key)</pre>
<div class="block">Gets a Integer from a Map in a null-safe manner.
 <p>
 The Integer is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Integer, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getLong(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getLong(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getLong</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang">Long</a>&nbsp;getLong(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
               K&nbsp;key)</pre>
<div class="block">Gets a Long from a Map in a null-safe manner.
 <p>
 The Long is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Long, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getFloat(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getFloat(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getFloat</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Float.html?is-external=true" title="class or interface in java.lang">Float</a>&nbsp;getFloat(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                 K&nbsp;key)</pre>
<div class="block">Gets a Float from a Map in a null-safe manner.
 <p>
 The Float is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Float, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getDouble(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getDouble(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getDouble</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang">Double</a>&nbsp;getDouble(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                   K&nbsp;key)</pre>
<div class="block">Gets a Double from a Map in a null-safe manner.
 <p>
 The Double is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Double, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getMap(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getMap(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getMap</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;getMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                  K&nbsp;key)</pre>
<div class="block">Gets a Map from a Map in a null-safe manner.
 <p>
 If the value returned from the specified map is not a Map then
 <code>null</code> is returned.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Map, <code>null</code> if null map input</dd></dl>
</li>
</ul>
<a name="getObject(java.util.Map,java.lang.Object,java.lang.Object)">
<!--   -->
</a><a name="getObject(java.util.Map, K, V)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getObject</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;V&nbsp;getObject(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
                K&nbsp;key,
                V&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting null into the
 given default value.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map, or defaultValue if the original value
   is null or the map is null</dd></dl>
</li>
</ul>
<a name="getString(java.util.Map,java.lang.Object,java.lang.String)">
<!--   -->
</a><a name="getString(java.util.Map, K, java.lang.String)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getString</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;getString(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                   K&nbsp;key,
                   <a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 a string, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a string, or defaultValue if the
   original value is null, the map is null or the string conversion fails</dd></dl>
</li>
</ul>
<a name="getBoolean(java.util.Map,java.lang.Object,java.lang.Boolean)">
<!--   -->
</a><a name="getBoolean(java.util.Map, K, java.lang.Boolean)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBoolean</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</a>&nbsp;getBoolean(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                     K&nbsp;key,
                     <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</a>&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 a boolean, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a boolean, or defaultValue if the
   original value is null, the map is null or the boolean conversion fails</dd></dl>
</li>
</ul>
<a name="getNumber(java.util.Map,java.lang.Object,java.lang.Number)">
<!--   -->
</a><a name="getNumber(java.util.Map, K, java.lang.Number)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getNumber</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a>&nbsp;getNumber(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                   K&nbsp;key,
                   <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Number.html?is-external=true" title="class or interface in java.lang">Number</a>&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 a number, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a number, or defaultValue if the
   original value is null, the map is null or the number conversion fails</dd></dl>
</li>
</ul>
<a name="getByte(java.util.Map,java.lang.Object,java.lang.Byte)">
<!--   -->
</a><a name="getByte(java.util.Map, K, java.lang.Byte)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getByte</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Byte.html?is-external=true" title="class or interface in java.lang">Byte</a>&nbsp;getByte(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
               K&nbsp;key,
               <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Byte.html?is-external=true" title="class or interface in java.lang">Byte</a>&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 a byte, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a number, or defaultValue if the
   original value is null, the map is null or the number conversion fails</dd></dl>
</li>
</ul>
<a name="getShort(java.util.Map,java.lang.Object,java.lang.Short)">
<!--   -->
</a><a name="getShort(java.util.Map, K, java.lang.Short)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getShort</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Short.html?is-external=true" title="class or interface in java.lang">Short</a>&nbsp;getShort(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                 K&nbsp;key,
                 <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Short.html?is-external=true" title="class or interface in java.lang">Short</a>&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 a short, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a number, or defaultValue if the
   original value is null, the map is null or the number conversion fails</dd></dl>
</li>
</ul>
<a name="getInteger(java.util.Map,java.lang.Object,java.lang.Integer)">
<!--   -->
</a><a name="getInteger(java.util.Map, K, java.lang.Integer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getInteger</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</a>&nbsp;getInteger(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                     K&nbsp;key,
                     <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</a>&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 an integer, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a number, or defaultValue if the
   original value is null, the map is null or the number conversion fails</dd></dl>
</li>
</ul>
<a name="getLong(java.util.Map,java.lang.Object,java.lang.Long)">
<!--   -->
</a><a name="getLong(java.util.Map, K, java.lang.Long)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getLong</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang">Long</a>&nbsp;getLong(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
               K&nbsp;key,
               <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Long.html?is-external=true" title="class or interface in java.lang">Long</a>&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 a long, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a number, or defaultValue if the
   original value is null, the map is null or the number conversion fails</dd></dl>
</li>
</ul>
<a name="getFloat(java.util.Map,java.lang.Object,java.lang.Float)">
<!--   -->
</a><a name="getFloat(java.util.Map, K, java.lang.Float)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getFloat</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Float.html?is-external=true" title="class or interface in java.lang">Float</a>&nbsp;getFloat(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                 K&nbsp;key,
                 <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Float.html?is-external=true" title="class or interface in java.lang">Float</a>&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 a float, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a number, or defaultValue if the
   original value is null, the map is null or the number conversion fails</dd></dl>
</li>
</ul>
<a name="getDouble(java.util.Map,java.lang.Object,java.lang.Double)">
<!--   -->
</a><a name="getDouble(java.util.Map, K, java.lang.Double)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getDouble</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang">Double</a>&nbsp;getDouble(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                   K&nbsp;key,
                   <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang">Double</a>&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 a double, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a number, or defaultValue if the
   original value is null, the map is null or the number conversion fails</dd></dl>
</li>
</ul>
<a name="getMap(java.util.Map,java.lang.Object,java.util.Map)">
<!--   -->
</a><a name="getMap(java.util.Map, K, java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getMap</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;getMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                  K&nbsp;key,
                  <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;defaultValue)</pre>
<div class="block">Looks up the given key in the given map, converting the result into
 a map, using the default value if the the conversion fails.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose value to look up</dd><dd><code>key</code> - the key of the value to look up in that map</dd><dd><code>defaultValue</code> - what to return if the value is null or if the
   conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the map as a number, or defaultValue if the
   original value is null, the map is null or the map conversion fails</dd></dl>
</li>
</ul>
<a name="getBooleanValue(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getBooleanValue(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBooleanValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;boolean&nbsp;getBooleanValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                          K&nbsp;key)</pre>
<div class="block">Gets a boolean from a Map in a null-safe manner.
 <p>
 If the value is a <code>Boolean</code> its value is returned.
 If the value is a <code>String</code> and it equals 'true' ignoring case
 then <code>true</code> is returned, otherwise <code>false</code>.
 If the value is a <code>Number</code> an integer zero value returns
 <code>false</code> and non-zero returns <code>true</code>.
 Otherwise, <code>false</code> is returned.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Boolean, <code>false</code> if null map input</dd></dl>
</li>
</ul>
<a name="getByteValue(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getByteValue(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getByteValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;byte&nbsp;getByteValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                    K&nbsp;key)</pre>
<div class="block">Gets a byte from a Map in a null-safe manner.
 <p>
 The byte is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a byte, <code>0</code> if null map input</dd></dl>
</li>
</ul>
<a name="getShortValue(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getShortValue(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getShortValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;short&nbsp;getShortValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                      K&nbsp;key)</pre>
<div class="block">Gets a short from a Map in a null-safe manner.
 <p>
 The short is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a short, <code>0</code> if null map input</dd></dl>
</li>
</ul>
<a name="getIntValue(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getIntValue(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getIntValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;int&nbsp;getIntValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                  K&nbsp;key)</pre>
<div class="block">Gets an int from a Map in a null-safe manner.
 <p>
 The int is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as an int, <code>0</code> if null map input</dd></dl>
</li>
</ul>
<a name="getLongValue(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getLongValue(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getLongValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;long&nbsp;getLongValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                    K&nbsp;key)</pre>
<div class="block">Gets a long from a Map in a null-safe manner.
 <p>
 The long is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a long, <code>0L</code> if null map input</dd></dl>
</li>
</ul>
<a name="getFloatValue(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getFloatValue(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getFloatValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;float&nbsp;getFloatValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                      K&nbsp;key)</pre>
<div class="block">Gets a float from a Map in a null-safe manner.
 <p>
 The float is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a float, <code>0.0F</code> if null map input</dd></dl>
</li>
</ul>
<a name="getDoubleValue(java.util.Map,java.lang.Object)">
<!--   -->
</a><a name="getDoubleValue(java.util.Map, K)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getDoubleValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;double&nbsp;getDoubleValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                        K&nbsp;key)</pre>
<div class="block">Gets a double from a Map in a null-safe manner.
 <p>
 The double is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a double, <code>0.0</code> if null map input</dd></dl>
</li>
</ul>
<a name="getBooleanValue(java.util.Map,java.lang.Object,boolean)">
<!--   -->
</a><a name="getBooleanValue(java.util.Map, K, boolean)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getBooleanValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;boolean&nbsp;getBooleanValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                          K&nbsp;key,
                          boolean&nbsp;defaultValue)</pre>
<div class="block">Gets a boolean from a Map in a null-safe manner,
 using the default value if the the conversion fails.
 <p>
 If the value is a <code>Boolean</code> its value is returned.
 If the value is a <code>String</code> and it equals 'true' ignoring case
 then <code>true</code> is returned, otherwise <code>false</code>.
 If the value is a <code>Number</code> an integer zero value returns
 <code>false</code> and non-zero returns <code>true</code>.
 Otherwise, <code>defaultValue</code> is returned.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd><dd><code>defaultValue</code> - return if the value is null or if the conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a Boolean, <code>defaultValue</code> if null map input</dd></dl>
</li>
</ul>
<a name="getByteValue(java.util.Map,java.lang.Object,byte)">
<!--   -->
</a><a name="getByteValue(java.util.Map, K, byte)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getByteValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;byte&nbsp;getByteValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                    K&nbsp;key,
                    byte&nbsp;defaultValue)</pre>
<div class="block">Gets a byte from a Map in a null-safe manner,
 using the default value if the the conversion fails.
 <p>
 The byte is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd><dd><code>defaultValue</code> - return if the value is null or if the conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a byte, <code>defaultValue</code> if null map input</dd></dl>
</li>
</ul>
<a name="getShortValue(java.util.Map,java.lang.Object,short)">
<!--   -->
</a><a name="getShortValue(java.util.Map, K, short)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getShortValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;short&nbsp;getShortValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                      K&nbsp;key,
                      short&nbsp;defaultValue)</pre>
<div class="block">Gets a short from a Map in a null-safe manner,
 using the default value if the the conversion fails.
 <p>
 The short is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd><dd><code>defaultValue</code> - return if the value is null or if the conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a short, <code>defaultValue</code> if null map input</dd></dl>
</li>
</ul>
<a name="getIntValue(java.util.Map,java.lang.Object,int)">
<!--   -->
</a><a name="getIntValue(java.util.Map, K, int)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getIntValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;int&nbsp;getIntValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                  K&nbsp;key,
                  int&nbsp;defaultValue)</pre>
<div class="block">Gets an int from a Map in a null-safe manner,
 using the default value if the the conversion fails.
 <p>
 The int is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd><dd><code>defaultValue</code> - return if the value is null or if the conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as an int, <code>defaultValue</code> if null map input</dd></dl>
</li>
</ul>
<a name="getLongValue(java.util.Map,java.lang.Object,long)">
<!--   -->
</a><a name="getLongValue(java.util.Map, K, long)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getLongValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;long&nbsp;getLongValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                    K&nbsp;key,
                    long&nbsp;defaultValue)</pre>
<div class="block">Gets a long from a Map in a null-safe manner,
 using the default value if the the conversion fails.
 <p>
 The long is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd><dd><code>defaultValue</code> - return if the value is null or if the conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a long, <code>defaultValue</code> if null map input</dd></dl>
</li>
</ul>
<a name="getFloatValue(java.util.Map,java.lang.Object,float)">
<!--   -->
</a><a name="getFloatValue(java.util.Map, K, float)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getFloatValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;float&nbsp;getFloatValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                      K&nbsp;key,
                      float&nbsp;defaultValue)</pre>
<div class="block">Gets a float from a Map in a null-safe manner,
 using the default value if the the conversion fails.
 <p>
 The float is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd><dd><code>defaultValue</code> - return if the value is null or if the conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a float, <code>defaultValue</code> if null map input</dd></dl>
</li>
</ul>
<a name="getDoubleValue(java.util.Map,java.lang.Object,double)">
<!--   -->
</a><a name="getDoubleValue(java.util.Map, K, double)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getDoubleValue</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;double&nbsp;getDoubleValue(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,?&gt;&nbsp;map,
                        K&nbsp;key,
                        double&nbsp;defaultValue)</pre>
<div class="block">Gets a double from a Map in a null-safe manner,
 using the default value if the the conversion fails.
 <p>
 The double is obtained from the results of <a href="../../../../org/apache/commons/collections4/MapUtils.html#getNumber(java.util.Map, K)"><code>getNumber(Map,Object)</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to use</dd><dd><code>key</code> - the key to look up</dd><dd><code>defaultValue</code> - return if the value is null or if the conversion fails</dd>
<dt><span class="strong">Returns:</span></dt><dd>the value in the Map as a double, <code>defaultValue</code> if null map input</dd></dl>
</li>
</ul>
<a name="toProperties(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toProperties</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</a>&nbsp;toProperties(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</pre>
<div class="block">Gets a new Properties object initialised with the values from a Map.
 A null input will return an empty properties object.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to convert to a Properties object</dd>
<dt><span class="strong">Returns:</span></dt><dd>the properties object</dd></dl>
</li>
</ul>
<a name="toMap(java.util.ResourceBundle)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toMap</h4>
<pre>public static&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;toMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util">ResourceBundle</a>&nbsp;resourceBundle)</pre>
<div class="block">Creates a new HashMap using data copied from a ResourceBundle.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>resourceBundle</code> - the resource bundle to convert, may not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>the hashmap containing the data</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the bundle is null</dd></dl>
</li>
</ul>
<a name="verbosePrint(java.io.PrintStream, java.lang.Object, java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>verbosePrint</h4>
<pre>public static&nbsp;void&nbsp;verbosePrint(<a href="http://download.oracle.com/javase/6/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
                <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;label,
                <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;map)</pre>
<div class="block">Prints the given map with nice line breaks.
 <p>
 This method prints a nicely formatted String describing the Map.
 Each map entry will be printed with key and value.
 When the value is a Map, recursive behaviour occurs.
 <p>
 This method is NOT thread-safe in any special way. You must manually
 synchronize on either this class or the stream as required.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>out</code> - the stream to print to, must not be null</dd><dd><code>label</code> - The label to be used, may be <code>null</code>.
  If <code>null</code>, the label is not output.
  It typically represents the name of the property in a bean or similar.</dd><dd><code>map</code> - The map to print, may be <code>null</code>.
  If <code>null</code>, the text 'null' is output.</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the stream is <code>null</code></dd></dl>
</li>
</ul>
<a name="debugPrint(java.io.PrintStream, java.lang.Object, java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>debugPrint</h4>
<pre>public static&nbsp;void&nbsp;debugPrint(<a href="http://download.oracle.com/javase/6/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
              <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;label,
              <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;map)</pre>
<div class="block">Prints the given map with nice line breaks.
 <p>
 This method prints a nicely formatted String describing the Map.
 Each map entry will be printed with key, value and value classname.
 When the value is a Map, recursive behaviour occurs.
 <p>
 This method is NOT thread-safe in any special way. You must manually
 synchronize on either this class or the stream as required.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>out</code> - the stream to print to, must not be null</dd><dd><code>label</code> - The label to be used, may be <code>null</code>.
   If <code>null</code>, the label is not output.
   It typically represents the name of the property in a bean or similar.</dd><dd><code>map</code> - The map to print, may be <code>null</code>.
   If <code>null</code>, the text 'null' is output.</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the stream is <code>null</code></dd></dl>
</li>
</ul>
<a name="invertMap(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>invertMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;V,K&gt;&nbsp;invertMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</pre>
<div class="block">Inverts the supplied map returning a new HashMap such that the keys of
 the input are swapped with the values.
 <p>
 This operation assumes that the inverse mapping is well defined.
 If the input map had multiple entries with the same value mapped to
 different keys, the returned map will map one of those keys to the
 value, but the exact key which will be mapped is undefined.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to invert, may not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a new HashMap containing the inverted data</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the map is null</dd></dl>
</li>
</ul>
<a name="safeAddToMap(java.util.Map,java.lang.Object,java.lang.Object)">
<!--   -->
</a><a name="safeAddToMap(java.util.Map, K, java.lang.Object)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>safeAddToMap</h4>
<pre>public static&nbsp;&lt;K&gt;&nbsp;void&nbsp;safeAddToMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? super K,<a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;map,
                    K&nbsp;key,
                    <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)
                         throws <a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></pre>
<div class="block">Protects against adding null values to a map.
 <p>
 This method checks the value being added to the map, and if it is null
 it is replaced by an empty string.
 <p>
 This could be useful if the map does not accept null values, or for
 receiving data from a source that may provide null or empty string
 which should be held in the same way in the map.
 <p>
 Keys are not validated.
 Note that this method can be used to circumvent the map's
 value type at runtime.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to add to, may not be null</dd><dd><code>key</code> - the key</dd><dd><code>value</code> - the value, null converted to ""</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the map is null</dd></dl>
</li>
</ul>
<a name="putAll(java.util.Map, java.lang.Object[])">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>putAll</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;putAll(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
                    <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>[]&nbsp;array)</pre>
<div class="block">Puts all the keys and values from the specified array into the map.
 <p>
 This method is an alternative to the <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true#putAll(java.util.Map)" title="class or interface in java.util"><code>Map.putAll(java.util.Map)</code></a>
 method and constructors. It allows you to build a map from an object array
 of various possible styles.
 <p>
 If the first entry in the object array implements <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util"><code>Map.Entry</code></a>
 or <a href="../../../../org/apache/commons/collections4/KeyValue.html" title="interface in org.apache.commons.collections4"><code>KeyValue</code></a> then the key and value are added from that object.
 If the first entry in the object array is an object array itself, then
 it is assumed that index 0 in the sub-array is the key and index 1 is the value.
 Otherwise, the array is treated as keys and values in alternate indices.
 <p>
 For example, to create a color map:
 <pre>
 Map colorMap = MapUtils.putAll(new HashMap(), new String[][] {
     {"RED", "#FF0000"},
     {"GREEN", "#00FF00"},
     {"BLUE", "#0000FF"}
 });
 </pre>
 or:
 <pre>
 Map colorMap = MapUtils.putAll(new HashMap(), new String[] {
     "RED", "#FF0000",
     "GREEN", "#00FF00",
     "BLUE", "#0000FF"
 });
 </pre>
 or:
 <pre>
 Map colorMap = MapUtils.putAll(new HashMap(), new Map.Entry[] {
     new DefaultMapEntry("RED", "#FF0000"),
     new DefaultMapEntry("GREEN", "#00FF00"),
     new DefaultMapEntry("BLUE", "#0000FF")
 });
 </pre></div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to populate, must not be null</dd><dd><code>array</code> - an array to populate from, null ignored</dd>
<dt><span class="strong">Returns:</span></dt><dd>the input map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if map is null</dd>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if sub-array or entry matching used and an entry is invalid</dd>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/ClassCastException.html?is-external=true" title="class or interface in java.lang">ClassCastException</a></code> - if the array contents is mixed</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd></dl>
</li>
</ul>
<a name="emptyIfNull(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>emptyIfNull</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;emptyIfNull(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</pre>
<div class="block">Returns an immutable empty map if the argument is <code>null</code>,
 or the argument itself otherwise.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map, possibly <code>null</code></dd>
<dt><span class="strong">Returns:</span></dt><dd>an empty map if the argument is <code>null</code></dd></dl>
</li>
</ul>
<a name="isEmpty(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isEmpty</h4>
<pre>public static&nbsp;boolean&nbsp;isEmpty(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;map)</pre>
<div class="block">Null-safe check if the specified map is empty.
 <p>
 Null returns true.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to check, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if empty or null</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd></dl>
</li>
</ul>
<a name="isNotEmpty(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isNotEmpty</h4>
<pre>public static&nbsp;boolean&nbsp;isNotEmpty(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;map)</pre>
<div class="block">Null-safe check if the specified map is not empty.
 <p>
 Null returns false.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to check, may be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>true if non-null and non-empty</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd></dl>
</li>
</ul>
<a name="synchronizedMap(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>synchronizedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;synchronizedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</pre>
<div class="block">Returns a synchronized map backed by the given map.
 <p>
 You must manually synchronize on the returned buffer's iterator to
 avoid non-deterministic behavior:

 <pre>
 Map m = MapUtils.synchronizedMap(myMap);
 Set s = m.keySet();  // outside synchronized block
 synchronized (m) {  // synchronized on MAP!
     Iterator i = s.iterator();
     while (i.hasNext()) {
         process (i.next());
     }
 }
 </pre>

 This method uses the implementation in <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collections.html?is-external=true" title="class or interface in java.util"><code>Collections</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to synchronize, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a synchronized map backed by the given map</dd></dl>
</li>
</ul>
<a name="unmodifiableMap(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>unmodifiableMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;unmodifiableMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;? extends K,? extends V&gt;&nbsp;map)</pre>
<div class="block">Returns an unmodifiable map backed by the given map.
 <p>
 This method uses the implementation in the decorators subpackage.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to make unmodifiable, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>an unmodifiable map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the map is null</dd></dl>
</li>
</ul>
<a name="predicatedMap(java.util.Map, org.apache.commons.collections4.Predicate, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>predicatedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;&nbsp;predicatedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
                                   <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super K&gt;&nbsp;keyPred,
                                   <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super V&gt;&nbsp;valuePred)</pre>
<div class="block">Returns a predicated (validating) map backed by the given map.
 <p>
 Only objects that pass the tests in the given predicates can be added to the map.
 Trying to add an invalid object results in an IllegalArgumentException.
 Keys must pass the key predicate, values must pass the value predicate.
 It is important not to use the original map after invoking this method,
 as it is a backdoor for adding invalid objects.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to predicate, must not be null</dd><dd><code>keyPred</code> - the predicate for keys, null means no check</dd><dd><code>valuePred</code> - the predicate for values, null means no check</dd>
<dt><span class="strong">Returns:</span></dt><dd>a predicated map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the Map is null</dd></dl>
</li>
</ul>
<a name="transformedMap(java.util.Map, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>transformedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;&nbsp;transformedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
                                    <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super K,? extends K&gt;&nbsp;keyTransformer,
                                    <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super V,? extends V&gt;&nbsp;valueTransformer)</pre>
<div class="block">Returns a transformed map backed by the given map.
 <p>
 This method returns a new map (decorating the specified map) that
 will transform any new entries added to it.
 Existing entries in the specified map will not be transformed.
 If you want that behaviour, see <a href="../../../../org/apache/commons/collections4/map/TransformedMap.html#transformedMap(java.util.Map, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)"><code>TransformedMap.transformedMap(java.util.Map&lt;K, V&gt;, org.apache.commons.collections4.Transformer&lt;? super K, ? extends K&gt;, org.apache.commons.collections4.Transformer&lt;? super V, ? extends V&gt;)</code></a>.
 <p>
 Each object is passed through the transformers as it is added to the
 Map. It is important not to use the original map after invoking this
 method, as it is a backdoor for adding untransformed objects.
 <p>
 If there are any elements already in the map being decorated, they
 are NOT transformed.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to transform, must not be null, typically empty</dd><dd><code>keyTransformer</code> - the transformer for the map keys, null means no transformation</dd><dd><code>valueTransformer</code> - the transformer for the map values, null means no transformation</dd>
<dt><span class="strong">Returns:</span></dt><dd>a transformed map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the Map is null</dd></dl>
</li>
</ul>
<a name="fixedSizeMap(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>fixedSizeMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;&nbsp;fixedSizeMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</pre>
<div class="block">Returns a fixed-sized map backed by the given map.
 Elements may not be added or removed from the returned map, but
 existing elements can be changed (for instance, via the
 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true#put(K, V)" title="class or interface in java.util"><code>Map.put(Object,Object)</code></a> method).</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose size to fix, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a fixed-size map backed by that map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the Map is null</dd></dl>
</li>
</ul>
<a name="lazyMap(java.util.Map, org.apache.commons.collections4.Factory)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>lazyMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;&nbsp;lazyMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
                             <a href="../../../../org/apache/commons/collections4/Factory.html" title="interface in org.apache.commons.collections4">Factory</a>&lt;? extends V&gt;&nbsp;factory)</pre>
<div class="block">Returns a "lazy" map whose values will be created on demand.
 <p>
 When the key passed to the returned map's <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true#get(java.lang.Object)" title="class or interface in java.util"><code>Map.get(Object)</code></a>
 method is not present in the map, then the factory will be used
 to create a new object and that object will become the value
 associated with that key.
 <p>
 For instance:
 <pre>
 Factory factory = new Factory() {
     public Object create() {
         return new Date();
     }
 }
 Map lazyMap = MapUtils.lazyMap(new HashMap(), factory);
 Object obj = lazyMap.get("test");
 </pre>

 After the above code is executed, <code>obj</code> will contain
 a new <code>Date</code> instance.  Furthermore, that <code>Date</code>
 instance is the value for the <code>"test"</code> key in the map.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to make lazy, must not be null</dd><dd><code>factory</code> - the factory for creating new objects, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a lazy map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the Map or Factory is null</dd></dl>
</li>
</ul>
<a name="lazyMap(java.util.Map, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>lazyMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;&nbsp;lazyMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
                             <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super K,? extends V&gt;&nbsp;transformerFactory)</pre>
<div class="block">Returns a "lazy" map whose values will be created on demand.
 <p>
 When the key passed to the returned map's <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true#get(java.lang.Object)" title="class or interface in java.util"><code>Map.get(Object)</code></a>
 method is not present in the map, then the factory will be used
 to create a new object and that object will become the value
 associated with that key. The factory is a <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4"><code>Transformer</code></a>
 that will be passed the key which it must transform into the value.
 <p>
 For instance:
 <pre>
 Transformer factory = new Transformer() {
     public Object transform(Object mapKey) {
         return new File(mapKey);
     }
 }
 Map lazyMap = MapUtils.lazyMap(new HashMap(), factory);
 Object obj = lazyMap.get("C:/dev");
 </pre>

 After the above code is executed, <code>obj</code> will contain
 a new <code>File</code> instance for the C drive dev directory.
 Furthermore, that <code>File</code> instance is the value for the
 <code>"C:/dev"</code> key in the map.
 <p>
 If a lazy map is wrapped by a synchronized map, the result is a simple
 synchronized cache. When an object is not is the cache, the cache itself
 calls back to the factory Transformer to populate itself, all within the
 same synchronized block.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to make lazy, must not be null</dd><dd><code>transformerFactory</code> - the factory for creating new objects, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a lazy map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the Map or Transformer is null</dd></dl>
</li>
</ul>
<a name="orderedMap(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>orderedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/OrderedMap.html" title="interface in org.apache.commons.collections4">OrderedMap</a>&lt;K,V&gt;&nbsp;orderedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</pre>
<div class="block">Returns a map that maintains the order of keys that are added
 backed by the given map.
 <p>
 If a key is added twice, the order is determined by the first add.
 The order is observed through the keySet, values and entrySet.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to order, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>an ordered map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the Map is null</dd></dl>
</li>
</ul>
<a name="multiValueMap(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>multiValueMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/map/MultiValueMap.html" title="class in org.apache.commons.collections4.map">MultiValueMap</a>&lt;K,V&gt;&nbsp;multiValueMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,? super <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;V&gt;&gt;&nbsp;map)</pre>
<div class="block">Creates a mult-value map backed by the given map which returns
 collections of type ArrayList.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to decorate</dd>
<dt><span class="strong">Returns:</span></dt><dd>a multi-value map backed by the given map which returns ArrayLists of values.</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../org/apache/commons/collections4/map/MultiValueMap.html" title="class in org.apache.commons.collections4.map"><code>MultiValueMap</code></a></dd></dl>
</li>
</ul>
<a name="multiValueMap(java.util.Map, java.lang.Class)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>multiValueMap</h4>
<pre>public static&nbsp;&lt;K,V,C extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;V&gt;&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/map/MultiValueMap.html" title="class in org.apache.commons.collections4.map">MultiValueMap</a>&lt;K,V&gt;&nbsp;multiValueMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,C&gt;&nbsp;map,
                                                             <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;C&gt;&nbsp;collectionClass)</pre>
<div class="block">Creates a multi-value map backed by the given map which returns
 collections of the specified type.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dd><code>C</code> - the collection class type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to decorate</dd><dd><code>collectionClass</code> - the type of collections to return from the map (must contain public no-arg constructor
   and extend Collection).</dd>
<dt><span class="strong">Returns:</span></dt><dd>a multi-value map backed by the given map which returns collections of the specified type</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../org/apache/commons/collections4/map/MultiValueMap.html" title="class in org.apache.commons.collections4.map"><code>MultiValueMap</code></a></dd></dl>
</li>
</ul>
<a name="multiValueMap(java.util.Map, org.apache.commons.collections4.Factory)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>multiValueMap</h4>
<pre>public static&nbsp;&lt;K,V,C extends <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;V&gt;&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/map/MultiValueMap.html" title="class in org.apache.commons.collections4.map">MultiValueMap</a>&lt;K,V&gt;&nbsp;multiValueMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,C&gt;&nbsp;map,
                                                             <a href="../../../../org/apache/commons/collections4/Factory.html" title="interface in org.apache.commons.collections4">Factory</a>&lt;C&gt;&nbsp;collectionFactory)</pre>
<div class="block">Creates a multi-value map backed by the given map which returns
 collections created by the specified collection factory.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dd><code>C</code> - the collection class type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to decorate</dd><dd><code>collectionFactory</code> - a factor which creates collection objects</dd>
<dt><span class="strong">Returns:</span></dt><dd>a multi-value map backed by the given map which returns collections
   created by the specified collection factory</dd><dt><span class="strong">Since:</span></dt>
  <dd>3.2</dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../org/apache/commons/collections4/map/MultiValueMap.html" title="class in org.apache.commons.collections4.map"><code>MultiValueMap</code></a></dd></dl>
</li>
</ul>
<a name="synchronizedSortedMap(java.util.SortedMap)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>synchronizedSortedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;synchronizedSortedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map)</pre>
<div class="block">Returns a synchronized sorted map backed by the given sorted map.
 <p>
 You must manually synchronize on the returned buffer's iterator to
 avoid non-deterministic behavior:

 <pre>
 Map m = MapUtils.synchronizedSortedMap(myMap);
 Set s = m.keySet();  // outside synchronized block
 synchronized (m) {  // synchronized on MAP!
     Iterator i = s.iterator();
     while (i.hasNext()) {
         process (i.next());
     }
 }
 </pre>

 This method uses the implementation in <a href="http://download.oracle.com/javase/6/docs/api/java/util/Collections.html?is-external=true" title="class or interface in java.util"><code>Collections</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to synchronize, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a synchronized map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the map is null</dd></dl>
</li>
</ul>
<a name="unmodifiableSortedMap(java.util.SortedMap)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>unmodifiableSortedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;unmodifiableSortedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,? extends V&gt;&nbsp;map)</pre>
<div class="block">Returns an unmodifiable sorted map backed by the given sorted map.
 <p>
 This method uses the implementation in the decorators subpackage.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the sorted map to make unmodifiable, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>an unmodifiable map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the map is null</dd></dl>
</li>
</ul>
<a name="predicatedSortedMap(java.util.SortedMap, org.apache.commons.collections4.Predicate, org.apache.commons.collections4.Predicate)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>predicatedSortedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;predicatedSortedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map,
                                       <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super K&gt;&nbsp;keyPred,
                                       <a href="../../../../org/apache/commons/collections4/Predicate.html" title="interface in org.apache.commons.collections4">Predicate</a>&lt;? super V&gt;&nbsp;valuePred)</pre>
<div class="block">Returns a predicated (validating) sorted map backed by the given map.
 <p>
 Only objects that pass the tests in the given predicates can be added to the map.
 Trying to add an invalid object results in an IllegalArgumentException.
 Keys must pass the key predicate, values must pass the value predicate.
 It is important not to use the original map after invoking this method,
 as it is a backdoor for adding invalid objects.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to predicate, must not be null</dd><dd><code>keyPred</code> - the predicate for keys, null means no check</dd><dd><code>valuePred</code> - the predicate for values, null means no check</dd>
<dt><span class="strong">Returns:</span></dt><dd>a predicated map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the SortedMap is null</dd></dl>
</li>
</ul>
<a name="transformedSortedMap(java.util.SortedMap, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>transformedSortedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;transformedSortedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map,
                                        <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super K,? extends K&gt;&nbsp;keyTransformer,
                                        <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super V,? extends V&gt;&nbsp;valueTransformer)</pre>
<div class="block">Returns a transformed sorted map backed by the given map.
 <p>
 This method returns a new sorted map (decorating the specified map) that
 will transform any new entries added to it.
 Existing entries in the specified map will not be transformed.
 If you want that behaviour, see <a href="../../../../org/apache/commons/collections4/map/TransformedSortedMap.html#transformedSortedMap(java.util.SortedMap, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)"><code>TransformedSortedMap.transformedSortedMap(java.util.SortedMap&lt;K, V&gt;, org.apache.commons.collections4.Transformer&lt;? super K, ? extends K&gt;, org.apache.commons.collections4.Transformer&lt;? super V, ? extends V&gt;)</code></a>.
 <p>
 Each object is passed through the transformers as it is added to the
 Map. It is important not to use the original map after invoking this
 method, as it is a backdoor for adding untransformed objects.
 <p>
 If there are any elements already in the map being decorated, they
 are NOT transformed.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to transform, must not be null, typically empty</dd><dd><code>keyTransformer</code> - the transformer for the map keys, null means no transformation</dd><dd><code>valueTransformer</code> - the transformer for the map values, null means no transformation</dd>
<dt><span class="strong">Returns:</span></dt><dd>a transformed map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the SortedMap is null</dd></dl>
</li>
</ul>
<a name="fixedSizeSortedMap(java.util.SortedMap)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>fixedSizeSortedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;fixedSizeSortedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map)</pre>
<div class="block">Returns a fixed-sized sorted map backed by the given sorted map.
 Elements may not be added or removed from the returned map, but
 existing elements can be changed (for instance, via the
 <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true#put(K, V)" title="class or interface in java.util"><code>Map.put(Object,Object)</code></a> method).</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map whose size to fix, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a fixed-size map backed by that map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the SortedMap is null</dd></dl>
</li>
</ul>
<a name="lazySortedMap(java.util.SortedMap, org.apache.commons.collections4.Factory)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>lazySortedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;lazySortedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map,
                                 <a href="../../../../org/apache/commons/collections4/Factory.html" title="interface in org.apache.commons.collections4">Factory</a>&lt;? extends V&gt;&nbsp;factory)</pre>
<div class="block">Returns a "lazy" sorted map whose values will be created on demand.
 <p>
 When the key passed to the returned map's <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true#get(java.lang.Object)" title="class or interface in java.util"><code>Map.get(Object)</code></a>
 method is not present in the map, then the factory will be used
 to create a new object and that object will become the value
 associated with that key.
 <p>
 For instance:

 <pre>
 Factory factory = new Factory() {
     public Object create() {
         return new Date();
     }
 }
 SortedMap lazy = MapUtils.lazySortedMap(new TreeMap(), factory);
 Object obj = lazy.get("test");
 </pre>

 After the above code is executed, <code>obj</code> will contain
 a new <code>Date</code> instance.  Furthermore, that <code>Date</code>
 instance is the value for the <code>"test"</code> key.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to make lazy, must not be null</dd><dd><code>factory</code> - the factory for creating new objects, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a lazy map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the SortedMap or Factory is null</dd></dl>
</li>
</ul>
<a name="lazySortedMap(java.util.SortedMap, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>lazySortedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;lazySortedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;map,
                                 <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;? super K,? extends V&gt;&nbsp;transformerFactory)</pre>
<div class="block">Returns a "lazy" sorted map whose values will be created on demand.
 <p>
 When the key passed to the returned map's <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true#get(java.lang.Object)" title="class or interface in java.util"><code>Map.get(Object)</code></a>
 method is not present in the map, then the factory will be used
 to create a new object and that object will become the value
 associated with that key. The factory is a <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4"><code>Transformer</code></a>
 that will be passed the key which it must transform into the value.
 <p>
 For instance:
 <pre>
 Transformer factory = new Transformer() {
     public Object transform(Object mapKey) {
         return new File(mapKey);
     }
 }
 SortedMap lazy = MapUtils.lazySortedMap(new TreeMap(), factory);
 Object obj = lazy.get("C:/dev");
 </pre>

 After the above code is executed, <code>obj</code> will contain
 a new <code>File</code> instance for the C drive dev directory.
 Furthermore, that <code>File</code> instance is the value for the
 <code>"C:/dev"</code> key in the map.
 <p>
 If a lazy map is wrapped by a synchronized map, the result is a simple
 synchronized cache. When an object is not is the cache, the cache itself
 calls back to the factory Transformer to populate itself, all within the
 same synchronized block.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the map to make lazy, must not be null</dd><dd><code>transformerFactory</code> - the factory for creating new objects, must not be null</dd>
<dt><span class="strong">Returns:</span></dt><dd>a lazy map backed by the given map</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the Map or Transformer is null</dd></dl>
</li>
</ul>
<a name="populateMap(java.util.Map, java.lang.Iterable, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>populateMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;void&nbsp;populateMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
                     <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends V&gt;&nbsp;elements,
                     <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;V,K&gt;&nbsp;keyTransformer)</pre>
<div class="block">Populates a Map using the supplied <code>Transformer</code> to transform the elements
 into keys, using the unaltered element as the value in the <code>Map</code>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the <code>Map</code> to populate.</dd><dd><code>elements</code> - the <code>Iterable</code> containing the input values for the map.</dd><dd><code>keyTransformer</code> - the <code>Transformer</code> used to transform the element into a key value</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the map, elements or transformer are null</dd></dl>
</li>
</ul>
<a name="populateMap(java.util.Map, java.lang.Iterable, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>populateMap</h4>
<pre>public static&nbsp;&lt;K,V,E&gt;&nbsp;void&nbsp;populateMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map,
                       <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends E&gt;&nbsp;elements,
                       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;E,K&gt;&nbsp;keyTransformer,
                       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;E,V&gt;&nbsp;valueTransformer)</pre>
<div class="block">Populates a Map using the supplied <code>Transformer</code>s to transform the elements
 into keys and values.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dd><code>E</code> - the type of object contained in the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a></dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the <code>Map</code> to populate.</dd><dd><code>elements</code> - the <code>Iterable</code> containing the input values for the map.</dd><dd><code>keyTransformer</code> - the <code>Transformer</code> used to transform the element into a key value</dd><dd><code>valueTransformer</code> - the <code>Transformer</code> used to transform the element into a value</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the map, elements or transformers are null</dd></dl>
</li>
</ul>
<a name="populateMap(org.apache.commons.collections4.MultiMap, java.lang.Iterable, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>populateMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;void&nbsp;populateMap(<a href="../../../../org/apache/commons/collections4/MultiMap.html" title="interface in org.apache.commons.collections4">MultiMap</a>&lt;K,V&gt;&nbsp;map,
                     <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends V&gt;&nbsp;elements,
                     <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;V,K&gt;&nbsp;keyTransformer)</pre>
<div class="block">Populates a MultiMap using the supplied <code>Transformer</code> to transform the elements
 into keys, using the unaltered element as the value in the <code>MultiMap</code>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the <code>MultiMap</code> to populate.</dd><dd><code>elements</code> - the <code>Iterable</code> to use as input values for the map.</dd><dd><code>keyTransformer</code> - the <code>Transformer</code> used to transform the element into a key value</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the map, elements or transformer are null</dd></dl>
</li>
</ul>
<a name="populateMap(org.apache.commons.collections4.MultiMap, java.lang.Iterable, org.apache.commons.collections4.Transformer, org.apache.commons.collections4.Transformer)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>populateMap</h4>
<pre>public static&nbsp;&lt;K,V,E&gt;&nbsp;void&nbsp;populateMap(<a href="../../../../org/apache/commons/collections4/MultiMap.html" title="interface in org.apache.commons.collections4">MultiMap</a>&lt;K,V&gt;&nbsp;map,
                       <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang">Iterable</a>&lt;? extends E&gt;&nbsp;elements,
                       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;E,K&gt;&nbsp;keyTransformer,
                       <a href="../../../../org/apache/commons/collections4/Transformer.html" title="interface in org.apache.commons.collections4">Transformer</a>&lt;E,V&gt;&nbsp;valueTransformer)</pre>
<div class="block">Populates a MultiMap using the supplied <code>Transformer</code>s to transform the elements
 into keys and values.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dd><code>E</code> - the type of object contained in the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/Iterable.html?is-external=true" title="class or interface in java.lang"><code>Iterable</code></a></dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the <code>MultiMap</code> to populate.</dd><dd><code>elements</code> - the <code>Iterable</code> containing the input values for the map.</dd><dd><code>keyTransformer</code> - the <code>Transformer</code> used to transform the element into a key value</dd><dd><code>valueTransformer</code> - the <code>Transformer</code> used to transform the element into a value</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://download.oracle.com/javase/6/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if the map, collection or transformers are null</dd></dl>
</li>
</ul>
<a name="iterableMap(java.util.Map)">
<!--   -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>iterableMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4">IterableMap</a>&lt;K,V&gt;&nbsp;iterableMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;K,V&gt;&nbsp;map)</pre>
<div class="block">Get the specified <a href="http://download.oracle.com/javase/6/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util"><code>Map</code></a> as an <a href="../../../../org/apache/commons/collections4/IterableMap.html" title="interface in org.apache.commons.collections4"><code>IterableMap</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - to wrap if necessary.</dd>
<dt><span class="strong">Returns:</span></dt><dd>IterableMap<K, V></dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
<a name="iterableSortedMap(java.util.SortedMap)">
<!--   -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>iterableSortedMap</h4>
<pre>public static&nbsp;&lt;K,V&gt;&nbsp;<a href="../../../../org/apache/commons/collections4/IterableSortedMap.html" title="interface in org.apache.commons.collections4">IterableSortedMap</a>&lt;K,V&gt;&nbsp;iterableSortedMap(<a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util">SortedMap</a>&lt;K,V&gt;&nbsp;sortedMap)</pre>
<div class="block">Get the specified <a href="http://download.oracle.com/javase/6/docs/api/java/util/SortedMap.html?is-external=true" title="class or interface in java.util"><code>SortedMap</code></a> as an <a href="../../../../org/apache/commons/collections4/IterableSortedMap.html" title="interface in org.apache.commons.collections4"><code>IterableSortedMap</code></a>.</div>
<dl><dt><span class="strong">Type Parameters:</span></dt><dd><code>K</code> - the key type</dd><dd><code>V</code> - the value type</dd><dt><span class="strong">Parameters:</span></dt><dd><code>sortedMap</code> - to wrap if necessary</dd>
<dt><span class="strong">Returns:</span></dt><dd><a href="../../../../org/apache/commons/collections4/IterableSortedMap.html" title="interface in org.apache.commons.collections4"><code>IterableSortedMap</code></a><K, V></dd><dt><span class="strong">Since:</span></dt>
  <dd>4.0</dd></dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar_bottom">
<!--   -->
</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
<!--   -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/MapUtils.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../index-all.html">Index</a></li>
<li><a href="../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../org/apache/commons/collections4/MapIterator.html" title="interface in org.apache.commons.collections4"><span class="strong">Prev Class</span></a></li>
<li><a href="../../../../org/apache/commons/collections4/MultiMap.html" title="interface in org.apache.commons.collections4"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?org/apache/commons/collections4/MapUtils.html" target="_top">Frames</a></li>
<li><a href="MapUtils.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
  allClassesLink = document.getElementById("allclasses_navbar_bottom");
  if(window==top) {
    allClassesLink.style.display = "block";
  }
  else {
    allClassesLink.style.display = "none";
  }
  //-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_bottom">
<!--   -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &#169; 2001&#x2013;2013 <a href="http://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
</body>
</html>
